home *** CD-ROM | disk | FTP | other *** search
/ Mac Format 1996 April / MacFormat CD Edition MF36 (April 1996).iso / Shareware City / Developers / Tools Plus - GUI⁄Event libs / Tools Plus 2.6.1a Evaluat'n Kit / Tools Plus 2.6.1a / User Manual / Update History / Read Me! 2.5.3 -> 2.6 changes < prev    next >
Text File  |  1995-04-14  |  5KB  |  93 lines
  1. Tools Plus Changes: 2.5.3 to 2.6
  2. ~~~~~~~~~~~~~~~~~~~~~~~~~
  3. Display this document in Geneva 12pt.
  4.  
  5. You need to read this document if:
  6.    √ You are upgrading from an older version of Tools Plus. If you
  7.        are upgrading from a version older than 2.5.3, read all other
  8.        applicable change documents first.
  9.    √ If you have purchased Tools Plus 2.6 and it arrived with a
  10.        Tools Plus 2.5.2 User Manual. Double-bullets (••) denote changes
  11.        that are NOT in the printed manual.
  12.  
  13.  
  14.                                       * * * W A R N I N G * * *
  15.  
  16.           THIS UPDATE INCLUDES REVISIONS THAT MAY REQUIRE YOU
  17.           TO CHANGE PARTS OF YOUR EXISTING APPLICATION(S). 
  18.           PLEASE READ CAREFULLY.
  19.  
  20.  
  21. Tools Plus 2.6, released in May 1995, includes the following changes implemented since the previous version, 2.5.3:
  22.  
  23.   • Tools Plus 2.6 contains a new set of libraries and files.
  24.      Replace your existing Tools Plus files with the new ones included
  25.      in this update. Delete all your old copies of the Tools Plus
  26.      libraries and related files (C header, Pascal interface etc.)
  27.  
  28.   • Tools Plus is now available for CodeWarrior compilers (C/C++ and
  29.      Pascal for 680x0 and PowerPC processors).
  30.  
  31. •• A field in the TPPopUpMenuSpec structure (record) has been
  32.      changed for compatibility across all compilers.
  33.  
  34. •• The DrawThermometer routine was changed to ensure
  35.      compatibility across all compilers.
  36.  
  37.   • When an active field is deactivated on a modeless window, the
  38.      Edit menu’s Undo item is now automatically set to “Can’t Undo”
  39.      and is disabled.
  40.  
  41.   • If your application has open palettes and/or tool bar, and a
  42.      modal window (any type other than a dBoxProc) is active, and
  43.      your application is suspended, the palettes and tool bar now
  44.      reappear in the correct window layer when your application is
  45.      reactivated (resumed).
  46.  
  47.  
  48.  
  49.  
  50. ------------------------------------------------------------
  51. Tools Plus for CodeWarrior
  52. ~~~~~~~~~~~~~~~~~~~~~
  53. Tools Plus is now available for the complete series of Metrowerks compilers in addition to the currently supported Symantec compilers.  Tools Plus libraries are now available for:
  54.     Symantec (THINK) C/C++ (680x0)
  55.     THINK Pascal                  (680x0)
  56.     CodeWarrior C/C++         (680x0)
  57.     CodeWarrior Pascal        (680x0)
  58.     CodeWarrior C/C++         (PowerPC-native)
  59.     CodeWarrior Pascal        (PowerPC-native)
  60. Internally, portions of Tools Plus have been rewritten to ensure compatibility and transparency across all languages and compilers.  The only change that is visible to you, the programmer, is the DrawThermometer routine.
  61.  
  62. ------------------------------------------------------------
  63. •• The TPPopUpMenuSpec structure (record) has been changed to ensure compatibility with constants defined by Apple.  The useWFont field has been renamed to UseWindowFont.
  64.  
  65. ------------------------------------------------------------
  66. •• The interface to the DrawThermometer routine has been revised to ensure compatibility between all languages and compilers.  Replace the related passage in your User Manual with the following revised information:
  67.  
  68. DrawThermometer
  69. ~~~~~~~~~~~~~~
  70. Draw the standard Macintosh progress thermometer in the current window.
  71.  
  72.    pascal void DrawThermometer (const Rect *DisplayRect,
  73.                  long Value, long Maximum);
  74.  
  75.    procedure DrawThermometer (DisplayRect: RECT; Value: LONGINT;
  76.                  Maximum: LONGINT);
  77.  
  78.   DrawThermometer draws the standard Macintosh progress thermometer, such as the one seen in the Finder when a file is being copied or duplicated.  The thermometer is drawn according to the system that your Macintosh is running, and the settings of the monitor(s) on which the thermometer is displayed.  The thermometer drawn by this routine is always similar to the one seen in the Finder.
  79.  
  80.   DisplayRect is the display rectangle in the current window’s local co-ordinates.  If the rectangle is taller than it is wide, a vertical thermometer is created.  Otherwise a horizontal thermometer is drawn.
  81.  
  82.   Value and Maximum are used to express the percentage completed (completed = value ÷ maximum).  Progress is indicated in a left to right motion on horizontal thermometers, and from the bottom up on vertical ones.  Use negative values to have the thermometer indicate progress in the reverse direction.
  83.  
  84. Note: Even though DrawThermometer draws the thermometer very
  85.         quickly, it may not be fast enough for applications that perform
  86.         many thousands or even millions of operations during the
  87.         thermometer’s progression. In that case, use the toolbox’s
  88.         TickCount function to time calls to DrawThermometer at a less
  89.         frequent rate, perhaps once per second.
  90.  
  91. Warning: DrawThermometer must be called outside a
  92.               BeginUpdateScreen/EndUpdateScreen structure.
  93.